revXMLCreateTreeFromFileWithNamespaces
Type
function
Summary
Reads an XML file, optionally creating an XML tree and returning XML namespace tags and attributes as part of the tree.
Syntax
revXMLCreateTreeFromFileWithNamespaces(<filePath>, <parseBadData>, <createTree>, <sendMessages>)
Description
Use the revXMLCreateTreeFromFileWithNamespaces function to read the contents of an XML document and create an XML treefrom it in memory, XML namespace tags and attributes are included as part of the tree.
Use the revXMLCreateTreeFromFileWithNamespaces function to make and XML file into an XML Tree, ignoring XML Namespace related tags and functions. The revXMLCreateTreeFromFileWithNamespaces function returns namespace tags and attributes as part of the tree without doing any processing.
Use the revXMLCreateTreeFromFileWithNamespaces function when an application needs the namespace information to perform correctly.
If the parseBadData is true, the revXMLCreateTreeFromFileWithNamespaces function tries to parse XML data even if it is not well-formed. Otherwise, the function stops executing as soon as it encounters data that is not well-formed XML.
If the createTree is true, the function creates a tree structure in memory. Otherwise, the function simply parses the XML data without creating an XML tree.
If the sendMessages is true, the revXMLStartTree, revStartXMLNode, revStartXMLData, revEndXMLNode, and revXMLEndTree messages are sent while the file is being parsed. Otherwise, these messages are not sent.
If the revXMLCreateTreeFromFileWithNamespaces function encounters an error, it returns an error message starting with "xmlerr".
The revXMLCreateTreeFromFileWithNamespaces function is part of the XML library. To ensure that the function works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "XML" checkbox is checked.
Parameters
| Name | Type | Description |
|---|---|---|
filePath | The name and location of a file containing XML text. | |
parseBadData | bool | |
createTree | bool | |
sendMessages | bool |
Examples
revXMLCreateTreeFromFileWithNamespaces("New.xml",false,true,false)
if revXMLCreateTreeFromFileWithNamespaces(it,true,true,false) then next repeat
Related
function: revXMLValidateDTD, revXMLTrees, revXMLCreateTreeWithNamespaces
glossary: LiveCode custom library, return, XML tree, Standalone Application Settings, message, standalone application, XML, XML document, command, function
library: XML library
message: revStartXMLData, revStartXMLNode, revEndXMLNode, revXMLStartTree, revXMLEndTree
command: revXMLDeleteAllTrees, revXMLAppend
control structure: function
Compatibility and Support
Introduced
LiveCode 4.5.1
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile